home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Franz PD / Franz PD Disk #135 (1991-08)(Rhein-Sieg-Soft).zip / Franz PD Disk #135 (1991-08)(Rhein-Sieg-Soft).adf / ABC_V1.03 / ABC.Dok < prev    next >
Text File  |  1991-07-23  |  17KB  |  401 lines
  1.  
  2.                                                                    27.4.1991
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                B e d i e n u n g s a n l e i t u n g
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                              ABC V1.03
  23.  
  24.  
  25.               A m i g a B a s i c - C o n v e r t e r 
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.                        (c) by Henry König
  40.  
  41.                            Bornheide 71
  42.  
  43.                          2000 Hamburg 53
  44.  
  45.  
  47. 1.      Allgemeines
  48.         -----------
  49.         ACHTUNG: Dieses Programm braucht mindestens 1MB Speicher!
  50.         Dieses Programm formt Amiga-Basic-Programme oder GW-Basic-Programme
  51.         (MS-DOS) in GFA-Basic-Programme um. Bei GW-Basic werden zur Zeit nur
  52.         die Befehle berücksichtig die mit Amiga-Basic identisch sind.
  53.         Eine hunterprozentige Anpassung kann weder mit diesem noch mit
  54.         einem anderen Programm erzielt werden, weil das AmigaBasic eine
  55.         schlampige Programmierung fördert. Dieses Programm soll auch nur
  56.         eine Programmierhilfe für Basic-Programmierer sein, die ihre
  57.         Amiga-Basic-Programme in das schnelle und komfortable GFA-Basic
  58.         konvertieren wollen. Eigene Programme umzuformen erfordern nur
  59.         geringe Anpassungen per Hand, weil man ja weiß was das Programm
  60.         machen soll. Bei fremden Programmen (was nicht sein soll) kann schon
  61.         erhebliche Handarbeit erforderlich sein. Einen Großteil des erlaubten
  62.         schlampigen Programmierstils werden durch "ABC" beseitigt oder mit
  63.         Tricks genauso schlampig umgesetzt.
  64.         GFA-Programme sind ca. 5 bis 10x schneller als compilierte Amiga-
  65.         Basic-Programme.
  66.         Eine Umformung ins GFA-Format setzt den Besitz des GFA-Interpreters
  67.         voraus. Das umgeformte Programm muß mit "MERGE" geladen werden.
  68.         Es können auch LISTgeschützte AmigaBasic-Programme wieder LISTbar
  69.         gemacht werden.
  70.         HINWEIS: Sollten Sie dieses Programm einsetzen um fremde Programme
  71.         zu "knacken" oder umzuformen, so verstoßen Sie gegen das Urheber-
  72.         recht.
  73.  
  75. 1.1     Shareware
  76.         ---------
  77.         Diese Version speichert nur 300 Programmzeilen. Die Umwandlung und
  78.         Bildschirmausgabe ist nicht eingeschränkt.
  79.         Für 20,- DM erhalten Sie Ihr persönliches Paßwort. Mit Paßwort ist
  80.         keine Einschränkung vorhanden. Wer nur kleine Programme umformt
  81.         braucht keine Gebühr entrichten.
  82.  
  84. 1.2     Leistungsmerkmale
  85.         =================
  86.  
  87.         Splitting und Korrektur des Amiga-Basic-Programmes
  88.         --------------------------------------------------
  89.         - splittet Amiga-Basic-Programme,
  90.         - ersetzt Zeilennummern in Label,
  91.         - modifiziert FOR-...NEXT-Schleifen,
  92.         - überprüft und ergänzt IF-...THEN-Blöcke,
  93.         - überprüft Aussprünge aus Schleifen,
  94.         - überprüft Ein- und Aussprünge von Unterprogrammen.
  96. 1.2.1   Umfang der Umformung
  97.         --------------------
  98.         AmigaBasic verfügt über ca. 230 Befehlen gegenüber ca. 350 Befehlen
  99.         des GFA-Basic.
  100.         129 Befehle können unverändert übernommen werden,
  101.          16 Befehle sind nicht erforderlich,
  102.           5 Befehle sind nicht vorhanden,
  103.           7 Befehle werden nur teilweise angepaßt. Es werden Hinweise
  104.             gegeben was noch per Hand angepaßt werden muß.
  105.          73 Befehle werden durch dieses Programm ersetzt, angepaßt oder
  106.             mit Ersatz-Befehlen versehen.
  107.  
  108.  
  109.  
  110.  Voraussetzung für eine Umformung
  111.         --------------------------------
  112.         Das AmigaBasic-Programm muß als ASCII-Datei vorliegen.
  113.         Ein unsauber (schlecht) programmiertes AmigaBasic-Programm kann auch
  114.         nur eine mäßige Umformung ergeben. Die Hauptfehler der Amiga-Basic-
  115.         Programmierer:
  116.         - Einspringen in Unterprogramme mit GOTO
  117.         - Auspringen aus Unterprogrammen oder Schleifen
  118.         - Unterprogramme ohne RETURN
  119.         Bei Anfängern könnte man noch Verständnis haben, aber es gibt
  120.         Profis die so programmieren!
  121.         Je sorgfältiger das Quellprogramm programmiert wurde, umso besser
  122.         ist das Ergebnis.
  123.         Beispiele über unsauberes Programmieren sind im Abschnitt 3.
  124.  
  126.         Ergebnisse von Umwandlungen von Amiga-Basic-Programmen
  127.         ------------------------------------------------------
  128.         - 50 % der umgewandelten Programme sind sofort lauffähig
  129.         - 30 % nach geringen Anpassungen per Hand lauffähig
  130.         - 10 % benötigen erhebliche Anpassung, bedingt durch unsaubere
  131.           Programmierung
  132.         - 10 % sind so schlecht (unsauber) programmiert, daß der Autor
  133.           selber Probleme hätte
  134.         - 90 % der Befehle werden angepaßt oder mit Ersatz-Routinen
  135.           versehen
  136.         - bei nicht vorhandenen Befehlen wird ein Hinweis im Programm-
  137.           text eingefügt
  138.         - kann ein Befehl nicht hundertprozentig angepaßt werden, so
  139.           werden Hinweise im Programmtext eingefügt. Außer bei Menü-
  140.           kontrollen. Diese PROCEDUREN müssen per Hand angepaßt werden.
  141.         Die obigen Ergebnisse sind abhängig von der Qualität des Amiga- oder
  142.         GW-Basic-Programmes.
  144. 1.3     Handbuch drucken
  145.         ----------------
  146.         Stellen Sie ihren Drucker mit "Preferences" auf "Left Margin" 10
  147.         und "Right Margin" auf 93 ein wenn Sie einen Heftrand haben wollen.
  148.         Anzahl der Druckzeilen brauchen Sie nicht einstellen.
  149.  
  150.  
  152. 2.      Die Menüs:
  153.         ---------
  154.  
  155. 2.1     Projekt-Menü
  156.         ============
  157.  
  158. 2.1.1   Basic-Programm einlesen
  159.         -----------------------
  160.         Der Quelltext muß als ASCII-Datei vorliegen.
  162. 2.1.2   Programm beenden
  163.         ----------------
  164.         Rückkehr, nach vorheriger Sicherheitsabfrage, zur Workbench.
  165.  
  166.  
  168. 2.2     Umformung
  169.         =========
  170.  
  171. 2.2.1   Zuerst Quelltext splitten
  172.         -------------------------
  173.         Dieser Menüpunkt muß immer ausgeführt werden, wenn eine Umformung
  174.         erfolgen soll. Bei GFA-Basic ist nur ein Befehl je Zeile erlaubt
  175.         und der Amiga-Basic-Spagetti-Code muß angepaßt werden.
  176.         Mit diesem Menüpunkt werden alle Basic-Programme übersichtlicher.
  177.         IF/THEN-Zeilen werden auf ENDIF geprüft. Anweisungen hinter "THEN"
  178.         werden auf "GOTO","CALL" oder auf Variable geprüft und angepaßt.
  179.         FOR/NEXT-Schleifen werden überprüft und angepaßt.
  180.         Der gesplittete Quelltext sollte gespeichert und vor der Umwandlung
  181.         ins GFA-Basic nochmals getestet werden.
  182.         WICHIG: Es dürfen  k e i n e  Basic-Befehle hinter einem REM
  183.         stehen wenn das Programm Zeilennummern enthält.
  184.  
  186.         Lesen Sie unbedingt den Abschnitt 3. Programmierfehler!
  187.  
  188.  
  189. 2.2.2   AmigaBasic-Listschutz entfernen
  190.         -------------------------------
  191.         Haben Sie auch schon einmal ein AmigaBasic-Programm mit LIST-Schutz
  192.         gespeichert und dabei versehentlich Ihr Originalprogramm geschützt?
  193.         Das war ärgerlich, aber nun nicht mehr. Mit diesem Menüpunkt heben
  194.         Sie den LISTschutz Ihres AmigaBasic-Programms wieder auf.
  195.         Ohne Paßwort können aber nur Programme bis 5KB bearbeitet werden.
  196.         Mit Paßwort ist keine Einschränkung vorhanden.
  197.  
  199. 2.2.3   Quellsource nach Zielsource umformen
  200.         ------------------------------------
  201.         Zuerst "Quelltext splitten" aufrufen und das gesplittete Programm
  202.         testen!
  203.         Soweit es mir möglich war habe ich Routinen geschrieben die viele
  204.         Befehle anpassen. Ist eine Anpassung nicht möglich, so werden im
  205.         Quelltext Hinweise (REM's)
  206.  
  207.         - Syntax gemäß Handbuch eintragen
  208.         - Befehl nicht bekannt
  209.         - Befehl nicht erforderlich
  210.         - Variable anpassen
  211.           u. a. m.
  212.  
  213.         eingefügt. Sonstige Fehler werden am Quelltextanfang angefügt.
  214.         Eventuell sollte das Programm vorher nur gesplittet, gespeichert
  215.         und als Amiga-Basic-Programm getestet werden. So können viele Fehler
  216.         durch unsauberes Programmieren schon vorher ausgeschaltet werden.
  218.         Lesen Sie unbedingt den Abschnitt Programmierfehler!
  219.  
  220.  
  221. 2.2.4   Quelltext in Großbuchstaben wandeln
  222.         -----------------------------------
  223.         Dieser Menüpunkt ist u. a. für ABasic-Programme erforderlich, da
  224.         dieses Basic die Basic-Befehle nicht in Großbuchstaben umwandelt und
  225.         mein Programm zwischen Basic-Befehlen, Variablen und Label unter-
  226.         scheiden muß. Diesen Menüpunkt nicht bei AmigaBasic anwenden!
  227.  
  228.  
  229.  
  231. 2.2.5   Quelltext strukturieren
  232.         -----------------------
  233.         Dient zum Einrücken des Quelltextes bei Schleifen, IF/THEN-Abfragen,
  234.         FOR/NEXT und WHILE/WEND. Ist nicht für umgeformte Programme gedacht.
  235.  
  237. 2.2.6   Fehlerliste
  238.         -----------
  239.         Zeigt nur festgestellten Fehler auf dem Bildschirm an.
  240.  
  242. 2.3     Programm ausgeben
  243.         =================
  245. 2.3.1   Programm auf Screen
  246.         -------------------
  247.         Eingelesenen oder teilumgeformten Quelltext anzeigen. Auch ohne
  248.         Paßwort keine Einschränkung.
  250. 2.3.2   Programm auf Drucker
  251.         --------------------
  252.         Eingelesenen oder teilumgeformten Quelltext drucken. Ohne Paßwort
  253.         einschränkte Funktion.
  255. 2.3.3   Ziel-Programm speichern
  256.         -----------------------
  257.         Gesplitteten oder teilumgeformten Quelltext speichern. Der Quelltext
  258.         sollte mit der Endung ".split" oder ".lst" gespeichert werden.
  259.         Ohne Paßwort nur eingeschränkte Funktion.
  261.  
  262.  
  264. 3. Programmbeispiele und Fehler die nicht richtig umgeformt werden können.
  265.    Alle Beispiele stammen aus Amiga-Basic-Programmen.
  266.    -------------------------------------------------------------------------
  267. falsch                   nach der Umformung        richtig
  268.  
  269. taste:                   PROCEDURE taste           PROCEDURE taste
  270. x$=INKEY$                 x$=INKEY$                  taste1:
  271. IF x=0 THEN taste         IF x=0 THEN                x$=INKEY$
  272.                             GOTO taste               IF x=0 THEN
  273.                           ENDIF                        GOTO taste1
  274.                          RETURN                      ENDIF
  275.                                                    RETURN
  276. ----------------------------------------------------------------------------
  277. falsch     IF x = 3 THEN IF y=1 THEN GOTO liste: ELSE .....usw
  278. richtig                                            IF x = 3 THEN
  279.                                                      IF y = 1 THEN
  280.                                                        GOTO liste
  281.                                                      END IF
  282.                                                    ELSE
  283.                                                      ...usw
  284.                                                    END IF
  285. ----------------------------------------------------------------------------
  286. Unterprogramm                                      PROCEDURE unterprogramm
  287. IF x=13 THEN                                         IF x=13 THEN
  288.   GOTO Liste                                           GOSUB Liste
  289. END IF                                                 GOTO ende
  290. Anweisungen                                          END IF
  291. RETURN                                               Anweisungen
  292. Liste:                                               ende:
  293. Anweisungen                                        RETURN
  294. RETURN
  295.  
  296. Eine PROCEDURE (Unterprogramm) darf nicht mit GOTO angesprungen
  297. oder verlassen werden.
  298. ----------------------------------------------------------------------------
  299. WINDOW (1)               OPENW (1)                 WINDOW(1)
  300. ----------------------------------------------------------------------------
  301. GOTO Label:              GOTO Label                GOTO Label
  302. ----------------------------------------------------------------------------
  303. OPEN "r",#2,(namen$+"-R"),35
  304.                          OPEN "r",#2,(namen$+"-R"),35
  305.                                                   OPEN "r",#2,namen$+"-R",35
  306. Dateinamen dürfen nicht eingeklammert werden
  307.  
  308.  
  310. 4. Syntax-übersicht für AmigaBasic, GW-Basic und GFA-Basic
  311. ============================================================================
  312. Aus Platz- und Aktualitätsgründen wurde dieser Teil ausgelagert.
  313.  
  314.  
  315. 5.            Übersicht konvertierter AmigaBasic-Programme
  316.               ============================================
  317.  
  318. Die Bemerkungen sind keine Kritik an die Programmierer sondern Kritik an das
  319. AmigaBasic welches so eine schlampige Programmierung zuläßt!!!
  320.  
  321. Programmname    Quelle  Bemerkung
  322. ----------------------------------------------------------------------------
  323. Amiga-Latein    RW 4    4 Ausprünge aus FOR/NEXT, 26 PROCEDURE-Aufrufe und
  324.                         66 RETURNs, 287 IF- und 281 END IF-Anweisungen,
  325.                         5 Aussprünge aus PROCEDUREn und 2 PROCEDURE-Ansprünge
  326.                         mit GOTO. Vorher überarbeiten.
  327. BitPlanes       Extras  (Noch) nicht lauffähig
  328. Bitte-lesen     Extras  Nach der Umformung sofort lauffähig.
  329. Buchhaltung-80  Unbek.  17 PROCEDURE-Aufrufe und 36 RETURNs. 10 Aussprünge
  330.                         aus PROCEDUREN. Vorher überarbeiten.
  331. Bücherdatei     FRA 51  5 Aussprünge aus PROCEDUREN und FOR/NEXT-
  332.                         Schleifen. Vorher überarbeiten.
  333. ConvertFD       Extras  3 PROCEDURE-Aufrufe, 7 RETURNs und ein Aussprung
  334.                         aus einer PROCEDURE. Vorher überholen.
  335. CLogo           Extras  (Noch) nicht lauffähig, AREA und AREAFILL müssen
  336.                         angepaßt werden.
  337. Dame            M&T     Für die Mauskontrolle ist eine SCREEN-Struktur er-
  338.                         forderlich. Sonst lauffähig.
  339. Demo            Extras  Unterprogramme in SUB-Routinen müssen angepaßt wer-
  340.                         den.
  341. Dreier          Extras  Lauffähig, jedoch AREAFILL, AREA und ein OPENW per
  342.                         Hand anpassen.
  343. Ettikettendruck CAC 12  13 PROCEDURE-Aufrufe und 33 RETURNs, 11 PROCEDURE-
  344.                         Aussprünge. Programm muß vorher üerarbeitet werden.
  345.                         So ein Programm kann unter GFA-Basic nicht laufen.
  346. Farbpalette     M&T     Nach der Umformung sofort lauffähig.
  347. Gewitter        M&T     Nach der Umformung sofort lauffähig.
  348. Kaleidoskop     Extras  Nach der Umformung sofort lauffähig.
  349. Kelch           M&T     Nach der Umformung sofort lauffähig.
  350. Kommunik        Extras  OPEN "COM1:" per Hand anpassen. Keine Fehler.
  351. Mauer           M&T     GOTO-Aussprung aus einem Unterprogramm im Quelltext.
  352.                         Eine Zeile geändert, dann lauffähig.
  353. Regenbogen      M&T     AREA, AREAFILL und CIRCLE (Ellipse) müssen noch an-
  354.                         gepaßt werden.
  355. Speechd         Extras  5 PROCEDURE-Aufrufe, 7 RETURNs, 24 IF- und 25 ENDIFS,
  356.                         Aussprung aus einer PROCEDURE. Einige Variablen sind
  357.                         GFA-Befehle. Zur Anpassung sind gute Programmier-
  358.                         kenntnisse erforderlich!
  359. Spezialdruck    CAC 12  Weniger PROCEDURE-Aufrufe als RETURNs.
  360.                         Diverse PROCEDURE-Aussprünge. Nach 10 Minuten Hand-
  361.                         arbeit lauffähig.
  362. Tunnel          M&T     Nach der Umformung sofort lauffähig.
  363. Wald            M&T     AREA, AREAFILL mußten noch angepaßt werden, dann
  364.                         lauffähig.
  365. ZweiScreens     M&T     FRE(-1) und PTAB mußten entfernt werden, dann
  366.                         lauffähig.
  367. Quellennachweis
  368. ---------------
  369. CAC     = PD-Serie CACTUS #
  370. Extras  = Extras-Diskette des Amiga
  371. FRA     = PD-Serie Franz
  372. M&T     = Programmieren mit AMIGA-BASIC. Buch und Diskette des Verlages
  373.           Markt & Technik
  374. RW      = PD-Serie Rainer Wolf
  375.  
  376.  
  377.  
  378.  
  379.  Schlagwortregister
  380. ----------------------------------------------------------------------------
  381.  Allgemeines.....................................1.
  382.  Ausgabe des Zielsource..........................2.3
  383.  Basic-Programm einlesen.............................2.1.1
  384.  Befehlstabelle..................................4.
  385.  Fehlerliste.....................................2.2.5
  386.  Handbuch ausdrucken.............................1.3
  387.  Leistung........................................1.2
  388.  Listschutz entfernen............................2.2.2
  389.  Lizenzgebühr....................................1.1
  390.  Menüs...........................................2.0
  391.  Programm beenden................................2.1.2
  392.  Programmierfehler...............................3.
  393.  Quelltext splitten..............................2.2.1
  394.  Sharegebühr.....................................1.1
  395.  Strukturieren...................................2.25
  396.  Syntaxtabelle...................................4.
  397.  Umformung.......................................2.2
  398.  
  399. Für Hinweise auf Fehler, sowie für Verbesserungsvorschläge bin ich dankbar.
  400. Als Dankeschön gibt es die neue Version des Programmes. Diskette und
  401. frankierten Rückumschlag nicht vergessen.